home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / misc / und64_375.lha / und64.doc < prev   
Text File  |  1994-10-06  |  10KB  |  259 lines
  1. UNd64 v 37.5 (10.6.94)
  2. © Copyright 1994 Jess Sosnoski
  3.  
  4. DISCLAIMER:
  5. Use this program at your own risk!
  6. I assume no responsibility or liability for problems that occour by the use,
  7. modification, or existence of this product in any form.
  8. (I.E. If it makes your new 1942 monitor turn into cheese whiz, bon apetit!)
  9.  
  10. This program is copyrighted by Jess Sosnoski and is available as shareware.
  11. It may be distributed only under the following conditions:
  12. 1.)    Program and Documentation is not modified in any way.
  13. 2.)    Program and Documentation must be distributed together.
  14. 3.)    This package may not be used for commercial purposes.
  15. 4.)    Sale price must not exceed the cost of media and shipping plus a
  16.     nominal copying fee equaling no greater than fred fish charges.
  17. 5.)  I give permission to release this on CD-ROM.
  18.  
  19. Okay, now the docs...
  20.  
  21. WHAT DOES THIS THING DO ANYWAYZ?
  22. --------------------------------
  23. This program is designed to extract files from .d64 disk images found at
  24. WATSON.MBB.SFU.CA.
  25.  
  26. WHAT ARE .D64 DISK IMAGES?
  27. --------------------------
  28. Basically, the .d64 files are just the contents of a Commodore 1541
  29. formatted disk.  The file has every sector on the disk stored sequentially
  30. in it.
  31. This has equal convenience and inconvenience.  First, you can put a whole
  32. disk's worth of information in a file-However, extracting it is the trick!
  33. In the PC world, it appears that their C64 emulators or related utilities
  34. are capable of using .d64 images as virtual disks (how nice).
  35. I haven't run into any Amiga C64 emulators that do this, so I had to write
  36. a utility to take advantage of .d64 files.
  37.  
  38. This program reads in the nice 170K .d64 file, and then does some nice disk
  39. drive function emulation, and can list, extract, or test the files contained
  40. in the .d64 file.
  41.  
  42. USAGE
  43. -----
  44. From the Shell/CLI (only):
  45. und64 [command]{option} [filename]
  46.  
  47. Commands:
  48. l List Archive.
  49. x Extract files from archive.
  50. t Test files in archive.
  51.  
  52. Options:
  53. d Handle DELeted files
  54. * WARNING * Resurrecting DELeted files is risky business, if a new file
  55.             is partially written over part of a DEL'd file, you may also
  56.             get the end of another file as a surprise bonus. Or maybe
  57.             you'll just get a part of an already complete file. 
  58. a Handle ALL files.  This will allow extracting of splat files, or 
  59.   in other words, incorrectly closed files. Same warning as DEL files.
  60.   
  61. Filename:
  62. Name of the file including the .d64 extension (if exists).
  63.  
  64. If run without parameters, the program will provide usage information.
  65. To stop the program at any point press CTRL-C.
  66.  
  67. Example:
  68. und64 la FooBar.d64
  69.  
  70. Example Output:
  71.  
  72. UNd64 37.5 (10.5.94)
  73. © Copyright 1994 Jess Sosnoski / Paradigm Shift Software
  74. Reading file...
  75.  
  76. Disk Name:games             04 2a
  77.      Approx
  78. Blks  Bytes Type Filename
  79. ---------------------------------
  80.    1    254  PRG             star
  81.   66  16764  PRG        czar trek 
  82.  154  39116  DEL    hhm.0801-9ff0
  83.    1    254  DEL    hhm.9ff0-a000
  84.    1    254  DEL    hhm.c000-c080
  85.    1    254  DEL         hard hat
  86.   66  16764  PRG             kong
  87.    1    254  PRG        kong boot
  88.    3    762  DEL             root
  89.   33   8382  DEL            qfm96
  90.    2    508  DEL         centipod
  91.    9   2286  DEL            turbo
  92.  
  93.  
  94. Output Description
  95. ------------------
  96. Blocks: number of disk blocks it took up on the disk.
  97.         A disk block=256 bytes, 254 used for data.
  98. Approx Bytes: 254*Blocks.  This is to give an approximate filesize
  99.               Actual filesize should be smaller than or equal to this.
  100.             NOTE: If someone messed with the dir structure and 
  101.                   manually changed the nomber of blocks, this could
  102.                   give false information. If blocks>664, which is
  103.                   physically impossible, I set the length to 0.
  104. Type:  This will be DEL, PRG, SEQ, or USR.  This is for informational
  105.       purposes only, and does not affect outputted files.  For those of you
  106.       out there who are not Commodore users, PRG files are typically
  107.       programs/executables.  SEQ files are typically text files.  USR
  108.       can be about anything.  DEL files are deleted, you can list or 
  109.       attempt to extract them when using the d option.
  110.       There are also REL(ative) files, which are not supported.
  111.       REL files are 3-d type files with all kinds of side sectors
  112.       and records and junk--so I chose not to deal with them.
  113.       (as if they could be properly stored on a filesystem which does
  114.       not support them!)
  115.       
  116. Filename: Gee, I dunno.
  117.         NOTE: Filenames are converted to AmigaASCII, and any characters 
  118.         <32 or >127 are converted to printable characters.
  119.         Characters /"?:#*, are converted to -     
  120.  
  121. Output Messages
  122. ---------------
  123. ***Break
  124. You pressed CTRL-C and stopped execution.
  125.  
  126. * Extracting
  127. File is being extracted.
  128.     
  129. * Testing
  130. File is being tested for integrity
  131.  
  132. >>Extracting/Testing Errors:
  133. * Circular Link Found, File Truncated
  134. UNd64 found a circular link and cut the file off there.
  135. A circular link occours when a pointer to the next track & sector of a file
  136. points to a track & sector earlier in a file, and if this is not detected,
  137. it can make quite a mess on your hard drive.
  138. (Extracting forever is not good!)
  139.  
  140. * File size error (n bytes)
  141. This is either caused by circular links, inproper file size in the 
  142. directory block, or a corrupt file (possible disk error).  The number
  143. in parenthesis is the number of bytes the file actually was.
  144.  
  145. * File Exists! (R)ename (O)verwrite (S)kip (A)bort
  146. If a file already exists with the same name, this message appears.
  147. At this point you would select the first letter of the appropriate option
  148. and press return. Rename will ask you for a new name to give the file, 
  149. Overwrite will overwrite the file, Skip will skip extracting the file, and 
  150. Abort will stop the program A-la CTRL-C.
  151.  
  152.  
  153. WHY USE THIS PROGRAM
  154. --------------------
  155. If you have a 64 emulator, this program is useful.
  156. Or, you can extract the files, and later transfer them to a 64.
  157.  
  158. COMPATIBILITY
  159. -------------
  160. This program was written and compiled on an A600 running 2.05 (37.350) rom,
  161. and 2.1 workbench with 4MB Fast 2MB Chip, and a 120MB hard drive.  As far
  162. as I know, the compiler doesn't even support 2.0+, so it might even run
  163. on an antiquated 1.2 OS.  
  164. I haven't tested this on any other machines, so bug reports are welcome.
  165. (I know it needs at least ~180K free memory to run)
  166.  
  167. NOTES
  168. -----
  169. Some .d64 files do not have fully extractable programs on them.
  170. You may be able to extract the boot file(s), but other than that,
  171. you will need a virtual .d64 device.
  172. Some examples of disks that may do this would be flight simulator disks,etc.
  173.  
  174. HISTORY
  175. -------
  176. 37.1        First Release.  Written and compiled in PCQ Pascal 1.2d
  177.         (the PD release), assembled on A68k 2.71, disassembled
  178.         with IRA 1.02, re-assembled and optimized with PhxAss 3.30,
  179.         linked throughout with PhxLnk 2.03, and hunkmerged with
  180.         Imploder 4.0.
  181.         Basically, it does what is says it does.
  182.         It has a styleguide-compliant version string.
  183.         (or seems to be)
  184.         
  185. 37.2        Added circular-link checking and fixed a ctrl-c bug when
  186.         attempting to break while extracting (37.1 didn't stop).
  187.         Unfortunately c-l checking slows down extraction a wee bit.
  188.         Fixed REL file bug, it no longer lists or attempts to extract
  189.         these nasty little files.  Improved illegal filename character
  190.         checking.  Rewrote some parts of this doc.
  191.  
  192. 37.3        Speeded up circular-link check to take constant time O(1),
  193.         instead of summatory time, improved output.  Added duplicate
  194.         filename checking.  Improved illegal filename character checking.
  195.         Rewrote some more of the doc.
  196.  
  197. 37.4        Now primarily assembled with SNMA 1.39 instead of A68K, and
  198.         re-assembled & optimized with Phxass 3.71, producing shorter
  199.         faster code.  Added ability to process deleted and splat files,
  200.         put some filesize checking in.
  201.          
  202. 37.5        Assembled with SNMA 1.95, and skipped Phxass because it's 
  203.         optimization was causing GURU's-and I didn't want to mess
  204.         with the program to get it to work at 3am.  Added file
  205.         testing, support for locked, etc.. files, removed a few bugs,
  206.         rewrote some parts of code.  Improved output.
  207.         
  208. TODO
  209. ----
  210. -SAS/C (when I can afford it, E couldn't handle an iddy biddy 180K array)
  211. -Make it faster. (as of now it does a nice sequential read of the file).
  212. -An '020+ version, although it defies me how that would make it much faster.
  213. -Wildcard extraction
  214. -AmigaGuide docs (The doc is growing, so maybe when I'm bored someday...)
  215. -Archive recognition routines.  As of this point in time, you can give the
  216.  program a text file to extract from, and it will read it (results will be
  217.  interesting).  Unfortunately, .d64 files are raw disk images, and there is
  218.  no (reliable) way to tell them from any other data files (possibly size).
  219.  
  220. SILLY DREAMS
  221. ------------
  222. -Make it possible to create/modify .d64 diskimage files.  Copying files both
  223.  from and to, renaming, deleting, etc...
  224. -Make the above into a virtual disk .d64filesystem so that any program can
  225.  make diskimages that may be xferred to C-64's (yea right!)
  226. -Repair circular links (so the whole file can be extracted).
  227. -A GUI!!!
  228. -Full-speed cray supercomputer emulation.
  229. -Give you source code- MAYBE if I rewrite it in C
  230.  I would give source code if it would be useful, but PCQ pascal forced
  231.  me to resort to hacks to get the program to compile (*AND* run).
  232.  
  233. The Author's Addresses...
  234. -------------------------
  235. Jess Sosnoski
  236. 651 Hillside Drive
  237. Mount Carmel, PA  17851-2463
  238.  
  239. My Internet address (unless they put me on another machine or leave school):
  240. j8s@mc3b2.bloomu.edu
  241. and
  242. jlsosn@planetx.bloomu.edu
  243.  
  244. If you feel the irresistible need to send me money, gifts or an
  245. Amiga 4000 Tower, I will give a very gracious thank you.
  246.  
  247.        //
  248.       //  .
  249.      //  /|
  250.  \\ //  /_|
  251.   \x/ _/ _|MIGA...Waiting in Bahamian court!
  252.   
  253. Quote of the day:
  254. "Ain't that the best!!!"
  255.             -Sheldon
  256.  
  257.  
  258.  
  259.